home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 007a / cudup21.zip / CUDUP2.DOC < prev    next >
Text File  |  1991-09-14  |  16KB  |  366 lines
  1.  | Colorado Utilities Duplicate File Manager (CUDUP) (tm)
  2.  |
  3.  | version 2.1
  4.  |
  5.  | by
  6.  |
  7.  | Fred C. Hill
  8.  |
  9.  | Micro System Solutions (tm)
  10.  |
  11.  
  12.  
  13. Your first use of CUDUP constitutes agreement to the following license
  14. provisions.  If you do not agree to them please do not use this program.
  15.  
  16. CUDUP is a copyrighted program offered 'as is' for your personal use, 
  17. testing and evaluation. A limited license is granted to use and to 
  18. duplicate this program for your personal use. After a reasonable period 
  19. of time (approx 2 weeks) you are expected to register with the author or
  20. discontinue your use of this program.
  21.  
  22. Micro System Solutions authorizes you to make archive copies of this 
  23. software for the sole purpose of back-up and protecting your investment 
  24. from loss.  The executable version along with this documentation, in an 
  25. unmodified format, may be freely shared with anyone.
  26.  
  27. This software may be used by one person on as many computer systems as 
  28. that person uses. 
  29.  
  30. Micro System Solutions warrants any physical diskettes and documentation 
  31. provided to be free of defects in material and workmanship for a period 
  32. of 30 days from the date of receipt. If you notify us of such a defect 
  33. within the warranty period, Micro System Solutions will replace the 
  34. defective diskette(s) or documentation at no cost.
  35.  
  36. Ombudsman Policy
  37.  
  38. This program is produced by a member of the Association of Shareware 
  39. Professionals (ASP). ASP wants to make sure that the shareware principle 
  40. works for you.  If you are unable to resolve a shareware-related problem 
  41. with an ASP member by contacting the member directly, ASP may be able to 
  42. help.  The ASP Ombudsman can help you resolve a dispute or problem with 
  43. an ASP member, but does not provide technical support for members' products. 
  44. Please write to the ASP Ombudsman at 545 Grover Road, Muskegon, MI 49442-9427 
  45. or send a Compuserve message via Compuserve Mail to ASP Ombudsman 70007,3536
  46.  
  47. Trademarks
  48.  
  49. CUDUP, CUDM, CUVL, & CULBL are trademarks of Micro System Solutions.
  50.  
  51. Colorado Utilities is a trademark of Micro System Solutions.
  52.  
  53. Turbo Professional is a trademark Turbo Power Software
  54.  
  55. Turbo Pascal is a trademark of Borland International.
  56.  
  57. MS-DOS is a trademark of Microsoft Corporation.
  58.  
  59. IBM PC, XT, AT are registered trademarks of IBM Corporation.
  60.  
  61. ARC is a trademark of System Enhancement Associates (SEA)
  62.  
  63.  
  64. Additional Software
  65.  
  66. CUDUP requires no additional software to execute. It will, however, only 
  67. execute properly under MS/DOS version 3.0 and higher. (It has not been 
  68. tested under MS/DOS 4.x) You may elect to add one or more compression/
  69. decompression programs from the following list:
  70.  
  71.        file          
  72.        ext           pgm            company     version      comments
  73.  
  74.        ARC           PKPAK          PKWare        all
  75.        ARC           LARC           K. Miki              * using LHARC
  76.        LZH           LHARC          H.Yoshizaki   1.13
  77.        PAK           PAK                          1.6    * using ARC
  78.        ZIP           PKZIP          PKWare        1.01
  79.        ZOO           ZOO
  80.        ARC           ARC            SEA           6.0    * using PKPAK
  81.        DWC           DWC
  82.        LBR           LBR            
  83.        MD            MD     
  84.  
  85. CUDUP manipulates the files on your disk through standard DOS calls. 
  86. Neither the author nor Micro System Solutions accept any responsibility 
  87. for damaged or lost files, data or media from use of this program.
  88.  
  89. Hardware required
  90.  
  91. CUDUP runs on any 100% IBM compatible microcomputer.  It will use as much 
  92. memory as you have available for the program and the required data storage.  
  93. No disk files other than the program (.EXE) file are required. This 
  94. documentation assumes you will be running CUDUP from a hard drive installed 
  95. as drive C:, however CUDUP will run from any hard or floppy drive on your 
  96. system.
  97.  
  98. Although it has not been tested, CUDUP should run on a network drive as well.  
  99. No file locks are done however and contention problems may arise during file 
  100. deletions.  Each user should have a registered copy of CUDUP or the 
  101. organization should have a LAN site license. 
  102. ORDER FORM
  103.  
  104.                                               Date:_____________  
  105. FROM:  
  106.  
  107. Name:____________________________   Company:_________________________  
  108.   
  109. Address:_________________________  Title:___________________________  
  110.   
  111. City:______________________ State:________ Zip:___________  
  112.   
  113.  
  114. Telephone:_____________________ Home( )  Office ( )  
  115.  
  116. Where did you first get/hear of our product? ________________________ 
  117.   
  118. Colorado Utilities Duplicate File Manager (CUDUP)               $17.00
  119.        includes diskette with:
  120.                      1. Latest executable version
  121.                      2. Documentation on disk
  122.                      3. Shipping and Handling
  123.   
  124.        Shipping and Handling add:                               $ 5.00
  125.        For overseas shipment add:                               $ 3.00  
  126.  
  127.        Colorado customers add 3% state sales  
  128.            tax and appropriate local tax:                       $ _______
  129.   
  130.                                    Order Total:                 $ _______  
  131.   
  132. Diskette format   5.25"______ or 3.5"_______ (check one)  
  133.   
  134. Send to:                                 
  135.                           VISA or MASTERCARD ACCEPTED:  
  136.  Micro System Solutions   
  137.                                    (circle one)  
  138.  5048 W. Maplewood Ave.   
  139.                              Card No.___________________________ 
  140.  Littleton, CO  80123      
  141.                               Expiration Date:____/____  
  142.  
  143.                             Authorized 
  144.                             Signature:________________________________
  145.  
  146. Orders may also be placed by sending an EasyPlex message on Compuserve 
  147. to PPN 76060,102.  Please include your Visa or Mastercard information and 
  148. your name as it appears on the card, as well as a shipping address. 
  149. Executing CUDUP
  150.  
  151. Start CUDUP from the command line as follows:
  152.  
  153.   CUDUP [/25] [/43] [/50] [/M] [/E] [/X] [/?] [d..d]
  154.  
  155.        all parameters are optional and mutually exclusive.
  156.         
  157.        /25 /43 or /50 will initialize the program in either 25 line
  158.                 mode, or EGA 43 or VGA 50 line mode. If the correct
  159.                 monitor is not available the program will default to
  160.                 the startup mode.  The system will return to the
  161.                 startup mode when you Quit to DOS. You may select
  162.                 either /43 or /50 if you have an EGA or VGA screen.
  163.  
  164.        /M  - initializes the program using the monochrome (B&W) colorset.
  165.  
  166.        /E  - disables compression library expansion. Only DOS files will be 
  167.              processes during this session. This flag will revert to
  168.              the default expansion at the end of this session.
  169.  
  170.        /X  - disables use of expanded memory when swapping memory to delete 
  171.              or  list files contained in compression libraries.
  172.  
  173.        /?  - displays a help line describing the comand line options.
  174.  
  175.        [d..d] - d..d are the optional disk drives to read from.  The default 
  176.                 drive will be used if d is not provided. Up to four drives 
  177.                 may be included during one run. If there is insufficient 
  178.                 memory to read all files on all included drives, CUDUP will 
  179.                 stop reading and display those files it has found. CUDUP does 
  180.                 not check for duplicates until all files have been read.
  181.  
  182. CUDUP begins execution in the Main Menu. From this menu you may change the 
  183. operating environment such as screen colors, the scope of the duplicate file 
  184. test, and the files used in the match.  You then have the option of 
  185. 'Run'ning CUDUP to examine the disk files you have selected.  When you are
  186. finished with the list and hit the Esc key you will return to the Main Menu.
  187. You must select the Quit option to exit to DOS.
  188.  
  189. CUDUP reads all included disks.... storing selected DOS files.... reading 
  190. any of the implemented compression library files.... and storing the 
  191. selected internal filenames into a large memory array. When (and if) the 
  192. available memory becomes full CUDUP will continue reading directories but 
  193. will not add additional files into the array.
  194.  
  195. When CUDUP finishes reading all filenames to be included, the array is 
  196. sorted and non-duplicates are discarded. The remaining files (duplicates) 
  197. are displayed.
  198.  
  199. Browsing through the list of files is done using the cursor control keys.  
  200. The program will terminate and return to the menu when the Esc key is hit 
  201. while in the file list window.
  202. Deleting Files
  203.  
  204. To delete any of the duplicate files, you first position the cursor 
  205. (highlighted line) on the line containing the file to you want deleted. Hold 
  206. down the Ctrl key and hit 'D'.  Upper or lower case is accepted.  
  207. You will be asked to confirm the deletion by answering 'Y' to the question
  208. 'delete file?'. Any answer other than 'Y' will abort the delete and continue 
  209. with the file list. 
  210.  
  211. If the file to be deleted is a standard DOS file it will be deleted 
  212. immediately. (Remember that a compression library is a standard DOS file 
  213. and there may be duplicates on your disk. If you delete it you will also 
  214. delete the files contained within it.)
  215.  
  216. If the file is contained within one of the compression protocol library files 
  217. the appropriate program ('PKPAK', 'PKZIP', LHARC, etc.) will be called to 
  218. perform the actual deletion. No checks are made to insure the deletion took 
  219. place as requested.
  220.  
  221. If you delete the compressed library file the contents of that library will 
  222. remain on the duplicate list. Any attempt to delete those files will probably 
  223. result in an error. (No checks are currently made to insure the file is still 
  224. present.)
  225.  
  226. The current version performs all requested deletions as the request is made. 
  227. Future versions will provide an option to store all external calls to the 
  228. compression/decompression programs until you request an exit to DOS.
  229.  
  230. Listing Files
  231.  
  232. To list any of the duplicate files, you first position the cursor 
  233. (highlighted line) on the line containing the file to you want listed. Hold 
  234. down the Ctrl key and hit 'L'.  Upper or lower case is accepted.  
  235. If the file to be listed is a standard DOS file it will be processed by a
  236. built-in text file processor. If the file is compressed the appropriate 
  237. program ('PKPAK', 'PKZIP', LHARC, etc.) will be called to perform the actual 
  238. listing. No checks are made to insure the file is a listable file. 
  239. Files such as .EXE or .COM or binary data files may be listed but would not 
  240. have any meaning.
  241.  
  242. Environmental changes
  243.  
  244. CUDUP allows you to change the environment under which you operate. You make 
  245. changes from the Main Menu or when you enter the environment menu by hitting 
  246. the F10 key when in the file list. At the present time you may do any of the 
  247. following:
  248.  
  249. Colors & Monochrome (B&W)
  250.  
  251.        o   You will select the part of the environment you want to
  252.            change colors on, the menu, list window, error messages, 
  253.            regular messages, file compression window or the main 
  254.            status screen. 
  255.  
  256.            - Each of the parts of the selected window or menu is then
  257.              available for selection. The frame, body, selected item,
  258.              etc  depending on what is to be changed.  When you
  259.              select the part a color window pop's up and allows you
  260.              to use the arrow keys to select the color combination
  261.              you like.  Hit enter when on the color to effect the
  262.              change.
  263.  
  264.            - If you selected Monochrome from the menu or by the use of the 
  265.              '/M' option on the command line, then the default colors will 
  266.              be set automatically. 
  267.  
  268. Screen Lines
  269.  
  270.        o   Using this option you can select either 25 line mode
  271.            (standard), 43 line EGA mode or 50 line VGA mode. Of
  272.            course you must have the correct monitor for this option
  273.            to work.  It is ignored if the correct monitor is not in
  274.            place.
  275. Environmental changes (continued)
  276.  
  277. Files
  278.  
  279.        o   Select which of the compression protocols you wish to make active 
  280.            for the current and/or subsequent sessions. The following list of 
  281.            programs are, at the present time, the only ones the program 
  282.            expects to support. This could change if additional protocols 
  283.            surface. CUDUP will support as many protocol upgrades as is 
  284.            possible.  Any of the following protocols not currently supported 
  285.            can not be selected from the list.          
  286.  
  287.                      ARC version 6.0
  288.                      DWC version unknown 
  289.                      PAK currently version 1.6 ( plan to cover version 2.x)
  290.                      LARC currently implemented using LHARC
  291.                      LBR version unknown 
  292.                      LZH version 1.13 (expect new version any time)
  293.                      MD  version unknown 
  294.                      PKPAK not supported by PkWare. (implemented in CUDUP)
  295.                      PKZIP version 1.10 
  296.                      ZOO version unknown 
  297.  
  298.        When you 'turn on' an entry in the file table by hitting <Enter> you 
  299.        must fill in 6 entry fields. These are:
  300.  
  301.        Description: 12 characters describing the protocol  exp. ZIP ver 1.01
  302.  
  303.        Dlt File:     The name of the compression program used to perform 
  304.                      internal file deletions. This file must be in the 
  305.                      current DOS path. exp. PKZIP.EXE
  306.  
  307.        Ext:          File extention to look for when using this protocol. 
  308.                      Do not include the period.      exp. ZIP
  309.  
  310.        Delete option:up to 6 characters. This is the command line option used 
  311.                      when performing the delete function using the 
  312.                      compression protocol.   exp. -d
  313.  
  314.        Lst File:     The name of the compression program used to perform 
  315.                      internal file listings. This file must be in the 
  316.                      current DOS path.   exp. PKUNZIP.EXE
  317.  
  318.        List option:  up to 6 characters. This is the command line option 
  319.                      used when performing the list function using the 
  320.                      compression protocol.   exp. -cm
  321.  
  322.        When you 'turn off' an entry in the file table by hitting <Enter> the 
  323.         current fields will remain in effect but will be 'turned off' for at 
  324.         least this session.
  325. Environmental changes (continued)
  326.  
  327. Scope
  328.  
  329.        oScope is the degree to which CUDUP will check for duplicates.  
  330.         Normally CUDUP will only check filenames. There are times when 
  331.         this is not sufficient to find all "real" duplicates on the disk 
  332.         being examined.  Selecting Scope will allow you to add two 
  333.         additional tests to the duplicate check.  These are the file
  334.         size and the file creation date/time.  When you include either of 
  335.         these tests you are restricting the scope of files selected for 
  336.         display.
  337.  
  338. Match
  339.  
  340.        oMatch also restricts the duplicate tests made on the files on the 
  341.         disk being tested.  Select this menu option and when prompted you 
  342.         enter a wild card file mask for the group of files you want tested. 
  343.         The wild card mask is identical to the mask used on the DOS command 
  344.         line.  for example  *.DOC will only examine files with an extension 
  345.         of DOC.  
  346.  
  347. Delete confirm
  348.        oThere may be times when you wish to disable the delete confirmation 
  349.         request. Pressing enter while on this menu selection will turn 
  350.         Delete confirmation on and off.
  351.  
  352. Save
  353.  
  354.        oSelecting this option will allow you to save any of your changes to 
  355.         the executable file. (CUDUP.EXE)  For that reason you must not 
  356.         write protect the disk or set the executable to read-only unless you 
  357.         do not intend to use this feature.
  358.  
  359. Future Revisions
  360.  
  361. CUDUP is by no means complete.  Updates will be placed in Shareware 
  362. distribution channels as quickly as they become available and tested.
  363.  
  364.  
  365.               Thank you for trying CUDUP - Please register
  366.